home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / netutils / bsdup1.exe / BSDUP1.TXT next >
Text File  |  1993-09-13  |  10KB  |  237 lines
  1.  
  2.               NOVELL TECHNICAL INFORMATION DOCUMENT
  3.  
  4. TITLE:              Black Screen of Death
  5. DOCUMENT ID:        TID013403
  6. DOCUMENT REVISION:  A
  7. DATE:               13SEP93
  8. ALERT STATUS:       Yellow
  9. INFORMATION TYPE:   Symptom Solution
  10. README FOR:         BSDUP1.EXE
  11.  
  12. NOVELL PRODUCT and VERSION:
  13. NetWare Client for DOS/Windows
  14.  
  15. ABSTRACT:
  16. These newer files fix a problem when using Windows or Windows for
  17. Workgroups on a network.  The symptom is a blinking underlined curser in
  18. the upper left hand corner of the screen when entering a DOS box or DOS
  19. application and the workstation hangs.
  20. _________________________________________________________________
  21.  
  22. DISCLAIMER
  23. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. 
  24. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. 
  25. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION
  26. ONLY.  NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS
  27. INFORMATION.
  28. _________________________________________________________________
  29.  
  30. Self-Extracting File Name:  BSDUP1.EXE      Revision:  A
  31.  
  32. Files Included     Size     Date
  33.  
  34. \
  35.   BSDUP1.TXT              (This File)
  36.     VIPX.386        23850   5-11-93   version 1.15 (930511)
  37.   IPXODI.COM        30051   4-23-93   version 2.11 (930423)
  38.      LSL.COM        17760   7-28-93   version 2.02 (930728)
  39.  
  40.  
  41. I.  Description
  42. ---------------
  43.  
  44. These newer files fix a problem when using Windows or Windows for
  45. Workgroups on a network.  The symptom is a blinking underlined curser in
  46. the upper left hand corner of the screen when entering a DOS box or DOS
  47. application and the workstation hangs.  The following factors may
  48. contribute to the problem:
  49.  
  50. * Third-party device drivers or terminate-and-stay-resident (TSR)
  51. programs.
  52. * An incorrect system configuration including memory management.
  53. * I/O, memory, or IRQ confilcts.
  54. * Problems in VIPX.386.
  55. * A problem in the Windows 3.1 virtual timing driver (VTD).
  56.  
  57.  
  58. II.  VIPX.386
  59. -------------
  60.  
  61. VIPX.386 is a Windows 3.X virtualization driver for IPXODI.COM driver that
  62. was enhanced jointly by NOVELL and Microsoft.  It virtualizes requests to
  63. the globally loaded IPX driver.  When a request is made to IPX, VIPX will
  64. allocate a request buffer in the system's global memory, copy the original
  65. request to the global buffer and give the global request to IPX.  When the
  66. global request completes, IPX will call VIPX.  VIPX will then copy any
  67. results back to the original request buffer and call the application which
  68. submitted the request.
  69.                 
  70.  
  71. II.A.  Version Compatibility with Dedicated IPX
  72. -----------------------------------------------
  73.  
  74. Novell officially ceased maintenance on the dedicated IPX driver (IPX.OBJ)
  75. version 3.10 dated 11-21-91.  The last version of VIPX to explicitly
  76. support that driver is 1.10.  The current version of VIPX supports
  77. IPXODI.COM only.  It is strongly recommended that you update your dedicated
  78. IPX driver with IPXODI.COM when using versions of VIPX later than 1.10. 
  79. You can find the latest ODI drivers in the DOSUP?.ZIP file, currently
  80. DOSUP7.ZIP.
  81.  
  82.  
  83. II.B.  Packet Size Limitations
  84. ------------------------------
  85.  
  86. VIPX.386 will only virtualize packets which are 8000 (decimal) bytes or
  87. less.  Any DOS and Windows IPX or SPX applications which use networks with
  88. a physical packet size greater than 8000 bytes may not work with VIPX.386. 
  89. For example, IBM Token Ring can be configured to run with 16K packets.  A
  90. request by a DOS or Windows IPX application to send a 16K packet will be
  91. truncated to 8000 bytes.  On the other hand, any 16K packet that is
  92. received by the LAN driver will be dropped because VIPX cannot allocate a
  93. packet big enough to handle it.
  94.  
  95.  
  96. II.C.  Memory Manager Limitations
  97. ---------------------------------
  98.  
  99. When a request is passed up from IPX, VIPX will immediately test the
  100. request buffer to see if it is in global memory already.  If it is in
  101. global memory, the request will be passed back down to IPX without any
  102. virtualization.  For example, a TSR loaded before Windows is considered to
  103. be in global memory.  If that TSR calls IPX, VIPX will test the requests
  104. and pass them back down to IPX.  This is done because there is no need to
  105. virtualize requests which are already global.
  106.  
  107. The use of UMA memory complicates the test for global memory.  There are
  108. two basic scenarios.  Scenario One is when a TSR has been loaded high
  109. before Windows was loaded.  In this case, IPX requests will come from
  110. global UMA memory.  VIPX will simply pass these requests back down to IPX. 
  111. Scenario Two is when a TSR is loaded high in a Windows DOSBOX.  In this
  112. case, IPX requests will come from local UMA memory.  VIPX will virtualize
  113. these requests.
  114.  
  115. Some memory managers test for global UMA memory and will work properly
  116. under both scenarios.  However, there are other memory managers that do not
  117. work properly under Windows.  With these drivers, all LOCAL DOSBOX UMAs
  118. look as if they are GLOBAL UMAs.  Under Scenario Two, when a TSR calls IPX,
  119. VIPX will test the request buffer and think that it is in global UMA memory
  120. when it is really in LOCAL UMA memory.  As a result, VIPX will pass a local
  121. ECB to IPX without virtualization.  The normal result of this is a hung
  122. machine or data corruption.
  123.  
  124. If you are using third party memory managers and hang, don't load TSRs
  125. USING THE IPX INTERFACE (INCLUDING IPX ITSELF) HIGH.  THEY MUST BE LOADED
  126. IN CONVENTIONAL MEMORY.
  127.  
  128.  
  129. III.  Specialized Configuration Parameters
  130. ------------------------------------------
  131.  
  132. Under most circumstances, VIPX will work fine under the default
  133. configuration.  However, there may be some applications which require
  134. custom configuration of the driver.  This is a list of SYSTEM.INI
  135. parameters which can be used to configure VIPX:
  136.  
  137. [VIPX]
  138. VipxMappingPages          =[number of 4K pages]  (default = 16)
  139. VipxFailOverSizedPackets  =[ON|OFF|TRUE|FALSE]   (default = OFF)
  140. VirtualizeIrq[0-F]        =[ON|OFF|TRUE|FALSE]   (default = OFF)
  141.  
  142. III.A.  VipxMappingPages
  143. ------------------------
  144.  
  145. This is the number of pages that VIPX can use to globalize requests to the
  146. global IPXODI.COM driver.  VIPX is not absolutely guaranteed to have all of
  147. these pages available at any one point, since this is the requested number
  148. of pages for SHARED global mapping which VIPX makes to the Windows VMM at
  149. initialization time.
  150.  
  151.  
  152. III.B.  VipxFailOverSizedPackets
  153. --------------------------------
  154.  
  155. This parameter tells VIPX to fail any requests which require more than the
  156. maximum allowed globalization size.  The actual maximum will vary according
  157. to which media the user is on.  The absolute maximum is 8000 (decimal)
  158. bytes.  With media that have smaller packets than 8000 bytes, the maximum
  159. allowed size is the maximum packet size that can be put onto the media.
  160.  
  161.  
  162. III.C.  VirtualizeIrq[0-F]
  163. --------------------------
  164.  
  165. VIPX 1.15 avoids a deadlock between the PC and Network Interface Card (NIC)
  166. by virtualizing the NIC's IRQ(s).  With ODI and dedicated IPX (IPX.OBJ)
  167. drivers, VIPX will automatically read the configuration of the NIC from the
  168. driver and virtualize the selected IRQs.  However, when using the IBM LAN
  169. Support Program with either SLANSUP.OBJ or LANSUP.COM, the LAN IRQ is not
  170. readable from the driver.  The only way to get this information is to read
  171. the NIC hardware itself.  The problem with doing this is that the hardware
  172. can be Token Ring, PCN2 or Ethernet.  VIPX must now be aware of many
  173. different hardware configurations. Instead of this, VIPX requires the IBM
  174. LAN Support user to specify the NIC's IRQ in the [VIPX] section of the
  175. SYSTEM.INI.  IRQs range from 0 to F (hex).  An example is listed below:
  176.  
  177. [VIPX]
  178. VirtualizeIrq2=TRUE
  179. VirtualizeIrq3=TRUE
  180.  
  181. In this example, VIPX will virtualize both IRQ 2 and IRQ 3.  VIPX can
  182. virtualize up to 4 different LAN IRQs.  The reason for virtualizing
  183. multiple IRQs is to allow other LAN cards and protocols to be installed on
  184. the same PC and prevent them from deadlocking the PC.  For example, you may
  185. have IPX running through an NE2000 card on IRQ 3 and TCP/IP running through
  186. to an IBM Token Ring card on IRQ 2.
  187.  
  188.  
  189. III.D.  TimerCriticalSection
  190. ----------------------------
  191.  
  192. As of version 1.15 of VIPX, TimerCriticalSection is required to be set on. 
  193. The recommended setting is as follows:
  194.  
  195. [386Enh]
  196. TimerCriticalSection=10000
  197.  
  198. The reason for this parameter is to avoid a deadlock with the LAN IRQ
  199. Virtualization code.  See section III.C VirtualizeIrq[0-F].
  200.  
  201.  
  202. IV.  IPXODI.COM
  203. ---------------
  204.  
  205. IPXODI.COM had a bug in SPX.  During a retry, SPX would jump to invalid
  206. memory causing an invalid opcode exception in v86 mode only when SPX is
  207. being used.  Few applications use SPX.  This usually manifests itself as a
  208. reboot, hung machine or blank screen with cursor in upper left corner. 
  209. This version of IPXODI.COM should be used instead of the one found in
  210. DOSUP7.ZIP.
  211.  
  212.  
  213. V.  LSL.COM
  214. -----------
  215.  
  216. LSL.COM had a number of bugs and one was a bug that caused a deadlock
  217. situation with the LAN adapter.  A Do Send for Windows needed a Start and
  218. End Critical Section call added.  It is now language enabled.  A memory
  219. calculation bug when calculating the amount of memory to reserve when going
  220. TSR is fixed.  This version of LSL.COM should be used instead of the one
  221. found in DOSUP7.ZIP.  It will only take about 300 bytes of extra memory.
  222.  
  223.  
  224. VI.  INSTALLATION
  225. -----------------
  226.  
  227. * Rename or backup the old VIPX.386, IPXODI.COM and LSL.COM.
  228. * Copy IPXODI.COM and LSL.COM to where the NIC software is initialized.
  229. * Copy VIPX.386 to your WINDOWS\SYSTEM directory.
  230. * Virtualize the NIC's IRQ in the [VIPX] section of the System.ini if using
  231. IBM LAN SUPPORT.
  232. * Put TimerCriticalSection=10000 in the [386Enh] section of the
  233. System.ini.
  234. * Reboot the PC and load the ODI drivers.
  235. * Enter windows.
  236.  
  237.